home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 72 / maccd 72.iso / online / NetFinder 2.1.2 ƒ / NetFinder Script Components / Modules / Module Doco / 3rd Party Module Info / amc-0.3 / 1st.README next >
Encoding:
Text File  |  2000-04-10  |  3.4 KB  |  99 lines  |  [TEXT/ttxt]
  1. * COPYRIGHT
  2.  
  3.         The ici module collection is,
  4.  
  5.     Copyright (C) 1999, A.Newman, All Rights Reserved.
  6.  
  7. You may freely use the module collection in any program or product as
  8. long as the author is credited in the documentation accompanying the
  9. program or product. The code is not guaranteed to operate to any degree
  10. of robustness and is provided "AS IS" with no support. Blah, blah, blah.
  11.  
  12. Now that's over...
  13.  
  14.  
  15. * INTRODUCTION
  16.  
  17. This is Andy Newman's collection of modules for ici. The modules provide
  18. ici programs access to common libraries, protocols, etc... or provide
  19. generally useful functionality for many programs.
  20.  
  21. See the file NEWS for information on changes and the file TODO for the
  22. start a list of things that need to be done. The file MODULES gives a
  23. short list of the available modules and the MANIFEST file lists all the
  24. files in the collection.
  25.  
  26.  
  27. * BUILDING
  28.  
  29. You need the latest ici (2.1.2 at time of writing, 2.1.1 should
  30. work too) installed before starting. The module collection assumes
  31. ici gets installed in its "usual" place (/usr/local), the headers
  32. are in /usr/local/include/ici and modules get installed under
  33. /usr/local/lib/ici. If that's not true then things may not work
  34. without changes to makefiles.
  35.  
  36. To build the collection on supported platforms type "make". The
  37. top-level makefile configures and build the entire collection. If a
  38. module is not supported for a particular configuration it is not
  39. built. The top-level makefile has the following targets:
  40.  
  41.     all        Build everything.
  42.     install        Install everything.
  43.     uninstall    Remove everything "make install" installed.
  44.     clean        Clean up object files, etc...
  45.     clobber        Remove all generated files.
  46.     config        Run the configure program.
  47.     depend        Build dependencies.
  48.     manifest    Build a list of all the files in the file MANIFEST.
  49.     tar        Build a tar file from the files named in the MANIFEST.
  50.     tgz        As for tar but gzip it.
  51.  
  52. Each module makefile also defines the all, install, clean, and depend
  53. targets. If you plan to do development work its wise to build dependencies.
  54. I use the BSD mkdep and have an ici clone of it for systems without it.
  55.  
  56. All targets will perform a "make config" if it hasn't been done. This runs
  57. the configure program which creates symbolic links to system specific
  58. Makefiles for each module. It is NOT an autoconf generated configure script
  59. and is quite dumb by comparison. It should be a lot smarter but does for
  60. the present time.
  61.  
  62.  
  63. * INSTALLING
  64.  
  65. Once built the modules should be installed with "make install". This
  66. assumes the existence of the /usr/local/lib/ici directory and permission
  67. to write files there.
  68.  
  69.  
  70. * PORTING
  71.  
  72. To configure the system for an unsupported platform the configure
  73. program will need to be extended to recognise that platform and
  74. Makefiles written for the platform. Then you build and fix the
  75. portability bugs. Nothing to it!
  76.  
  77. If you do port any of the modules to some platform please send the
  78. changes back so others can share your efforts and not duplicate
  79. tedious work.
  80.  
  81.  
  82. * SUPPORT PLATFORMS
  83.  
  84. RedHat Linux        Both libc5 and glibc systems work.
  85.             See */Makefile.linux.
  86.  
  87. FreeBSD            2.2.8 works. Not known how 3.x behaves.
  88.             I suspect the FreeBSD port of ici lacks
  89.             the -export-dynamic flag to cc which is
  90.             needed for proper module support but I
  91.             can't test this and can't be sure.
  92.             See */Makefile.bsd
  93.  
  94. Solaris            Works with Solaris 2.5.1 with gcc. The
  95.             build requires GNU make. I haven't tried
  96.             the tcl or wings modules as I don't have
  97.             them installed on my Solaris machine.
  98.             See */Makefile.sol2
  99.